home *** CD-ROM | disk | FTP | other *** search
/ Stone Design / Stone Design.iso / Stone_Friends / Wave / WavesWorld / Source / Libraries / tcl7.4b3 / doc / CrtInterp.3 < prev    next >
Encoding:
Text File  |  1994-12-17  |  1.5 KB  |  49 lines
  1. '\"
  2. '\" Copyright (c) 1989-1993 The Regents of the University of California.
  3. '\" Copyright (c) 1994 Sun Microsystems, Inc.
  4. '\"
  5. '\" See the file "license.terms" for information on usage and redistribution
  6. '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '\" 
  8. '\" @(#) CrtInterp.3 1.8 94/12/17 16:17:12
  9. '\" 
  10. .so man.macros
  11. .HS Tcl_CreateInterp tclc
  12. .BS
  13. .SH NAME
  14. Tcl_CreateInterp, Tcl_DeleteInterp \- create and delete Tcl command interpreters
  15. .SH SYNOPSIS
  16. .nf
  17. \fB#include <tcl.h>\fR
  18. .sp
  19. Tcl_Interp *
  20. \fBTcl_CreateInterp\fR()
  21. .sp
  22. \fBTcl_DeleteInterp\fR(\fIinterp\fR)
  23. .SH ARGUMENTS
  24. .AS Tcl_Interp *interp
  25. .AP Tcl_Interp *interp in
  26. Token for interpreter to be destroyed.
  27. .BE
  28.  
  29. .SH DESCRIPTION
  30. .PP
  31. \fBTcl_CreateInterp\fR creates a new interpreter structure and returns
  32. a token for it.  The token is required in calls to most other Tcl
  33. procedures, such as \fBTcl_CreateCommand\fR, \fBTcl_Eval\fR, and
  34. \fBTcl_DeleteInterp\fR.
  35. Clients are only allowed to access a few of the fields of
  36. Tcl_Interp structures;  see the Tcl_Interp
  37. and \fBTcl_CreateCommand\fR man pages for details.
  38. The new interpreter is initialized with no defined variables and only
  39. the built-in Tcl commands.  To bind in additional commands, call
  40. \fBTcl_CreateCommand\fR.
  41. .PP
  42. \fBTcl_DeleteInterp\fR destroys a command interpreter and releases all of
  43. the resources associated with it, including variables, procedures,
  44. and application-specific command bindings.  After \fBTcl_DeleteInterp\fR
  45. returns the caller should never again use the \fIinterp\fR token.
  46.  
  47. .SH KEYWORDS
  48. command, create, delete, interpreter
  49.